# ESP32-S3 产品线

```{admonition} 本文引用的文件
:class: note

- [esp32s3/docs/1_hardware/1_index.rst](../../../products/mpython-s3/1_hardware/1_index.rst)
- [esp32s3/docs/1_hardware/1_2_Technical_parameters.rst](../../../products/mpython-s3/1_hardware/1_2_Technical_parameters.rst)
- [esp32s3/docs/boards/ledong_v2/1_hardware/1_index.rst](../../../products/ledong-v2/1_hardware/1_index.rst)
- [esp32s3/docs/boards/ledong_v2/1_hardware/1_2_Technical_parameters.rst](../../../products/ledong-v2/1_hardware/1_2_Technical_parameters.rst)
- [esp32s3/docs/4_xiaozhi/1_index.rst](../../../products/mpython-s3/4_xiaozhi/1_index.rst)
- [esp32s3/docs/4_xiaozhi/1_xiaozhi.rst](../../../products/mpython-s3/4_xiaozhi/1_xiaozhi.rst)
- [esp32s3/docs/4_xiaozhi/2_xiaozhi.rst](../../../products/mpython-s3/4_xiaozhi/2_xiaozhi.rst)
- [esp32s3/docs/3_examples/basics/11_lcd.rst](../../../products/mpython-s3/3_examples/basics/11_lcd.rst)
- `esp32s3/firmware/boards/mpython_v3/board.json`
- `esp32s3/firmware/boards/labplus_Ledong_v2/board.json`
- `esp32s3/firmware/boards/sdkconfig.spiram`
- `esp32s3/firmware/file_system/common/ui/home.py`
- `esp32s3/firmware/file_system/mpython_v3/ui/home.py`
- `esp32s3/firmware/file_system/labplus_Ledong_v2/ui/home.py`
```

## 产品概述
ESP32-S3 掌控板产品线面向 K12 创客与教育场景，提供基于 ESP32-S3 双核处理器的高性能开发平台。该系列以“易上手、强扩展、可落地”为核心价值，支持 MicroPython/C 语言开发，内置丰富的传感器、音频与显示能力，并集成小智 AI 助手与 LVGL 图形界面，便于快速构建语音交互、AI 视觉与物联网原型。

- 目标用户：K12 师生、创客开发者、教育项目团队、IoT/AI 原型工程师
- 核心价值：更强的算力与内存（PSRAM）、更丰富的板载外设、开箱即用的 AI 与 GUI 能力
- 适用场景：语音对话机器人、人机交互终端、数据采集与可视化、课堂实验与竞赛、边缘 AI 演示

**章节来源**
- [esp32s3/docs/1_hardware/1_2_Technical_parameters.rst:15-38](../../../products/mpython-s3/1_hardware/1_2_Technical_parameters.rst)
- [esp32s3/docs/boards/ledong_v2/1_hardware/1_2_Technical_parameters.rst:15-42](../../../products/ledong-v2/1_hardware/1_2_Technical_parameters.rst)

## 核心业务流程
本小节从“硬件—软件—应用”的视角梳理两条典型业务链路：标准掌控板 3.0 与乐动掌控 2.0 的使用流程。

```text
sequenceDiagram
participant U as "用户"
participant B as "掌控板(ESP32-S3)"
participant S as "屏幕(LVGL)"
participant A as "小智AI/云端"
participant N as "网络(WiFi)"
U->>B : 上电/唤醒
B->>N : 连接WiFi
N-->>B : 联网成功
B->>S : 初始化LVGL与UI
U->>B : 语音/按键输入
B->>A : 发送语音/意图请求
A-->>B : 返回响应文本/指令
B->>S : 更新界面/播放语音
U-->>B : 交互完成
```

- 关键节点：设备启动→联网→GUI初始化→语音/按键采集→AI推理或云端调用→结果渲染与反馈
- 差异点：乐动掌控 2.0 额外包含摄像头与电机接口，可在 UI 中接入人脸检测、语音识别等应用；掌控板 3.0 侧重通用交互与教学演示

**图示来源**
- [esp32s3/docs/4_xiaozhi/1_xiaozhi.rst:4-27](../../../products/mpython-s3/4_xiaozhi/1_xiaozhi.rst)
- [esp32s3/docs/3_examples/basics/11_lcd.rst:1-31](../../../products/mpython-s3/3_examples/basics/11_lcd.rst)

**章节来源**
- [esp32s3/docs/4_xiaozhi/1_index.rst:1-12](../../../products/mpython-s3/4_xiaozhi/1_index.rst)
- [esp32s3/docs/4_xiaozhi/2_xiaozhi.rst:14-37](../../../products/mpython-s3/4_xiaozhi/2_xiaozhi.rst)

## 功能模块清单
本节按“硬件能力—软件能力—应用特性”分层列出主要模块及其职责与验收要点。

- 硬件能力
  - 主控与存储：ESP32-S3 双核 240MHz、16MB Flash、8MB PSRAM
  - 显示：1.47英寸 LCD（ST7789，320x172），支持 LVGL 图形库
  - 音频：ES8388 解码 + NS4150 功放，双麦克风
  - 传感：QMI8658C 六轴、MMC5603 磁传感器、LTR-308 光线传感器
  - 交互：实体按键 A/B/Reset，触摸按键 P/Y/T/H/O/N，RGB 灯×3
  - 通信：Wi-Fi 802.11 b/g/n，蓝牙 5（BLE）
  - 乐动掌控 2.0 专属：GC0328 摄像头、两路电机驱动输出、HY2.0 拓展接口、1200mAh 电池

- 软件能力
  - 固件栈：ESP-IDF v5.x + MicroPython v1.24.1 + CMake
  - 图形界面：LVGL（lv_micropython）+ 封装 GUI 库，多页面导航
  - AI 助手：小智 AI（唤醒词检测、实时翻译、响应式交互）
  - 文件系统：按板型加载 file_system（mpython_v3 / labplus_Ledong_v2 / common）
  - 扩展模块：GPS、心率、RFID、MQTT、HTTP、OLED/LCD 驱动等

- 应用特性
  - 免编译固件烧录，一键体验小智 AI
  - 多应用首页：水平仪、人脸检测、时钟、语音识别、光线、声音、游戏等
  - 教学与竞赛：兼容 micro:bit 音乐模块，丰富示例代码

验收要点
- 屏幕显示正常、分辨率与刷新符合预期
- 音频输入/输出通路畅通，录音与播放无异常
- 传感器数据可读，角度/磁场/光线值合理
- WiFi/BLE 连接稳定，AI 请求能返回结果
- 乐动掌控 2.0 摄像头采集与电机控制可用

**章节来源**
- [esp32s3/docs/1_hardware/1_2_Technical_parameters.rst:15-38](../../../products/mpython-s3/1_hardware/1_2_Technical_parameters.rst)
- [esp32s3/docs/boards/ledong_v2/1_hardware/1_2_Technical_parameters.rst:15-42](../../../products/ledong-v2/1_hardware/1_2_Technical_parameters.rst)
- [esp32s3/docs/3_examples/basics/11_lcd.rst:1-31](../../../products/mpython-s3/3_examples/basics/11_lcd.rst)
- [esp32s3/docs/4_xiaozhi/1_xiaozhi.rst:4-27](../../../products/mpython-s3/4_xiaozhi/1_xiaozhi.rst)

## 数据与状态
- 核心数据模型
  - 设备信息：MCU=ESP32-S3，Flash=16MB，PSRAM=8MB，屏幕=ST7789 320x172
  - 传感器数据：加速度/角速度/磁场强度/光线强度/音频响度
  - 网络状态：WiFi 连接/断开，AP 热点开启/关闭
  - 应用状态：GUI 页面路由、AI 会话状态（唤醒/对话/结束）

- 关键状态流转
  - 启动流程：Boot → 初始化外设（LCD/音频/传感器）→ 加载 GUI → 联网 → 进入首页
  - 交互流程：输入（语音/按键）→ 处理（本地或云端）→ 输出（显示/语音/灯光）
  - 电源管理：USB 供电/电池供电切换（乐动掌控 2.0）

- 数据所有权边界
  - 板端：传感器原始数据、本地缓存、UI 状态
  - 云端：AI 模型推理结果、TTS 语音合成、大模型对话上下文
  - 传输：通过 WiFi 加密通道进行数据交换

```text
flowchart TD
Start(["上电启动"]) --> Init["初始化外设与系统"]
Init --> Net{"是否联网?"}
Net --> |否| Local["本地模式运行"]
Net --> |是| Cloud["连接云端AI服务"]
Local --> UI["加载GUI首页"]
Cloud --> UI
UI --> Input{"用户输入"}
Input --> |语音| AI["语音识别/意图解析"]
Input --> |按键| Action["执行对应动作"]
AI --> Output["生成回复/控制指令"]
Action --> Output
Output --> Render["更新屏幕/播放语音/控制外设"]
Render --> End(["等待下一次输入"])
```

**章节来源**
- [esp32s3/docs/1_hardware/1_2_Technical_parameters.rst:15-38](../../../products/mpython-s3/1_hardware/1_2_Technical_parameters.rst)
- [esp32s3/docs/boards/ledong_v2/1_hardware/1_2_Technical_parameters.rst:15-42](../../../products/ledong-v2/1_hardware/1_2_Technical_parameters.rst)
- [esp32s3/docs/4_xiaozhi/1_xiaozhi.rst:4-27](../../../products/mpython-s3/4_xiaozhi/1_xiaozhi.rst)

## 关键约束与边界
- 非功能性需求
  - 功耗：最大工作电流约 500–700mA（视型号与负载），需满足供电与散热要求
  - 稳定性：PSRAM 启用后固件体积增大，需关注内存分配与溢出风险
  - 兼容性：不同板型的 file_system 与 UI 页面存在差异，需按板型选择固件

- 依赖与集成边界
  - 硬件依赖：ESP32-S3 芯片、ST7789 屏幕、ES8388 音频、各类传感器
  - 软件依赖：ESP-IDF v5.x、MicroPython v1.24.1、LVGL、小智 AI 固件
  - 网络依赖：Wi-Fi 连通性、云端 API 可用性（小智 AI/讯飞等）

- 业务约束
  - 乐动掌控 2.0 的摄像头与电机接口为可选扩展，需在 UI 与固件中启用相应功能
  - 小智 AI 需要联网与合适的 API 配置，离线模式仅支持本地基础功能
  - 不同板型的引脚与外设映射不同，移植时需核对 board.json 与 IO 文档

**章节来源**
- [esp32s3/docs/1_hardware/1_2_Technical_parameters.rst:54-60](../../../products/mpython-s3/1_hardware/1_2_Technical_parameters.rst)
- [esp32s3/docs/boards/ledong_v2/1_hardware/1_2_Technical_parameters.rst:44-50](../../../products/ledong-v2/1_hardware/1_2_Technical_parameters.rst)
- `esp32s3/firmware/boards/mpython_v3/board.json:6-11`
- `esp32s3/firmware/boards/labplus_Ledong_v2/board.json:6-11`
- `esp32s3/firmware/boards/sdkconfig.spiram:1-23`

## 两款主要产品与板型系列
- 掌控板 3.0（mpython_v3）
  - 定位：标准版 ESP32-S3 掌控板，适合教学与通用开发
  - 特点：LCD 彩屏、音频、六轴/磁力/光线传感器、WiFi/BLE、LVGL GUI、小智 AI
  - 参考：硬件参数与 IO 定义见硬件文档索引

- 乐动掌控 2.0（labplus_Ledong_v2）
  - 定位：带摄像头与电机驱动的互动版，适合机器人、AI 视觉与运动控制
  - 特点：在标准版基础上增加 GC0328 摄像头、两路电机驱动、HY2.0 拓展接口、电池供电
  - 参考：独立硬件文档与技术参数

- 板型系列（固件侧）
  - mpython_v3：标准 S3 掌控板
  - labplus_Ledong_v2：乐动版
  - labplus_for_xuejing：学境版
  - labplus_xunfei_js_middle / primary：讯飞 JS 中级/初级版

**章节来源**
- [esp32s3/docs/1_hardware/1_index.rst:1-11](../../../products/mpython-s3/1_hardware/1_index.rst)
- [esp32s3/docs/boards/ledong_v2/1_hardware/1_index.rst:1-11](../../../products/ledong-v2/1_hardware/1_index.rst)
- `esp32s3/firmware/boards/mpython_v3/board.json:15-16`
- `esp32s3/firmware/boards/labplus_Ledong_v2/board.json:15-16`

## 芯片升级与新特性
- 芯片升级
  - 采用 ESP32-S3 双核 Xtensa LX7，主频 240MHz，内置 FPU，支持 Wi-Fi 与 BLE 5
  - 存储与内存：16MB Flash + 8MB PSRAM，提升图形与 AI 任务处理能力
  - 构建系统：ESP-IDF v5.x + MicroPython v1.24.1 + CMake，工程化程度更高

- 新特性
  - 小智 AI：唤醒词检测、实时翻译、响应式交互，免编译固件一键体验
  - LVGL 图形界面：内置 lv_micropython，提供多页面 GUI 与自定义字体
  - PSRAM 优化：启用 SPIRAM 与相关优化选项，平衡固件大小与运行时内存

- 与 ESP32 的差异（概览）
  - 硬件层：ESP32-S3 更强算力与更大内存，新增/调整部分外设（如屏幕驱动、I2C 扩展）
  - 软件层：移除部分旧模块（如 radio/modcodec 等），新增 I2C 扩展与网络模块独立实现
  - 生态层：引入 LVGL GUI 与小智 AI，增强教育与 AI 场景能力

**章节来源**
- [esp32s3/docs/1_hardware/1_2_Technical_parameters.rst:15-38](../../../products/mpython-s3/1_hardware/1_2_Technical_parameters.rst)
- [esp32s3/docs/4_xiaozhi/1_xiaozhi.rst:4-27](../../../products/mpython-s3/4_xiaozhi/1_xiaozhi.rst)
- [esp32s3/docs/3_examples/basics/11_lcd.rst:1-31](../../../products/mpython-s3/3_examples/basics/11_lcd.rst)
- `esp32s3/firmware/boards/sdkconfig.spiram:1-23`

## 小智 AI 使用与集成
- 简介：小智 AI 是一款开源的硬件聊天机器人，支持多轮对话、情感化语音交流与主动思考，可部署于 ESP32-S3 实现低延迟语音聊天
- 快速上手：通过 mPython 软件切换到掌控板 3.0，选择小智固件烧录即可体验
- 功能：唤醒词检测、实时翻译、响应式交互；支持多种应用（语音识别、意图识别、智能服务）

```text
sequenceDiagram
participant Dev as "开发板"
participant SW as "mPython工具"
participant FW as "小智固件"
Dev->>SW : 选择板型与固件
SW->>FW : 烧录固件
FW-->>Dev : 启动并初始化AI模块
Dev->>FW : 语音输入/按键触发
FW-->>Dev : 返回对话/控制结果
```

**图示来源**
- [esp32s3/docs/4_xiaozhi/2_xiaozhi.rst:14-37](../../../products/mpython-s3/4_xiaozhi/2_xiaozhi.rst)
- [esp32s3/docs/4_xiaozhi/1_xiaozhi.rst:4-27](../../../products/mpython-s3/4_xiaozhi/1_xiaozhi.rst)

**章节来源**
- [esp32s3/docs/4_xiaozhi/1_index.rst:1-12](../../../products/mpython-s3/4_xiaozhi/1_index.rst)
- [esp32s3/docs/4_xiaozhi/2_xiaozhi.rst:14-37](../../../products/mpython-s3/4_xiaozhi/2_xiaozhi.rst)

## LVGL 图形界面与 UI 架构
- 图形库：内置 LVGL（lv_micropython），提供轻量级 GUI 能力，支持中文与多字体
- UI 结构：按板型维护 file_system/ui，包含首页与各应用页面（水平仪、人脸检测、时钟、语音识别、光线、声音、游戏）
- 页面导航：通过 change_route 与 lv_group 管理页面跳转与按键绑定

```text
graph TB
subgraph "UI层"
Home["首页(home.py)"]
Pages["应用页面(gradienter/face/clock/voice/light/sound/game)"]
end
subgraph "图形库"
LVGL["LVGL(lv_micropython)"]
GUI["封装GUI库"]
end
Home --> Pages
Pages --> LVGL
LVGL --> GUI
```

**图示来源**
- [esp32s3/docs/3_examples/basics/11_lcd.rst:1-31](../../../products/mpython-s3/3_examples/basics/11_lcd.rst)
- `esp32s3/firmware/file_system/common/ui/home.py:1-41`
- `esp32s3/firmware/file_system/mpython_v3/ui/home.py:1-41`
- `esp32s3/firmware/file_system/labplus_Ledong_v2/ui/home.py:1-41`

**章节来源**
- [esp32s3/docs/3_examples/basics/11_lcd.rst:1-31](../../../products/mpython-s3/3_examples/basics/11_lcd.rst)
- `esp32s3/firmware/file_system/common/ui/home.py:1-41`
- `esp32s3/firmware/file_system/mpython_v3/ui/home.py:1-41`
- `esp32s3/firmware/file_system/labplus_Ledong_v2/ui/home.py:1-41`

## 与 ESP32 的差异（对比要点）
- 硬件差异
  - 主控：ESP32-S3 双核 vs 原 ESP32 单/双核（具体取决于版本）
  - 内存：新增 8MB PSRAM，显著提升 GUI 与 AI 任务能力
  - 外设：屏幕驱动改为 ST7789，新增/调整 I2C 扩展与网络模块

- 软件差异
  - 构建系统：ESP-IDF v5.x + CMake，工程化更强
  - 模块变化：移除部分旧模块（radio/modcodec 等），新增 I2C 扩展与网络独立实现
  - 生态增强：引入 LVGL GUI 与小智 AI，完善教育与 AI 场景

- 开发影响
  - 迁移注意：IO 映射、外设驱动与模块 API 可能变化，需对照板型文档
  - 性能提升：更大的内存与更强 CPU，适合复杂 GUI 与 AI 应用
  - 工具链：建议使用 mPython IDE 与官方固件包，确保兼容性与易用性

**章节来源**
- [esp32s3/docs/1_hardware/1_2_Technical_parameters.rst:15-38](../../../products/mpython-s3/1_hardware/1_2_Technical_parameters.rst)
- [esp32s3/docs/boards/ledong_v2/1_hardware/1_2_Technical_parameters.rst:15-42](../../../products/ledong-v2/1_hardware/1_2_Technical_parameters.rst)
- `esp32s3/firmware/boards/sdkconfig.spiram:1-23`

## 总结
ESP32-S3 掌控板产品线以“更强算力、更大内存、更丰富外设”为核心，结合小智 AI 与 LVGL 图形界面，为教育与创客场景提供了高效、易用的开发平台。掌控板 3.0 与乐动掌控 2.0 分别覆盖通用开发与机器人/AI 视觉场景，满足不同层次的应用需求。通过规范的板型管理与模块化设计，开发者可快速搭建语音交互、数据采集与可视化、物联网原型等项目。